home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / bnchutil.arc / CONFIG.DOC < prev    next >
Text File  |  1991-04-30  |  11KB  |  311 lines
  1.  
  2. CONFIG.EXE Version 2.00 (12/14/88)
  3.            User Documentation
  4. -----------------
  5. Author: Bob Breedlove
  6.         3196 Swallows Nest Dr.
  7.         Sacramento, CA 95833
  8.         916-921-9373
  9.         916-929-7511 (BOBsBBS)
  10.  
  11.  
  12. USAGE:  CONFIG [{system name}] [/e/l]
  13.  
  14. PURPOSE: Config can be used to set up AUTOEXEC.BAT, CONFIG.SYS 
  15.          and other files to configure your system for various 
  16.          purposes.
  17.  
  18. HISTORY: I use my computer for many different purposes. These 
  19.          range from running BOBsBBS to writing articles. I find
  20.          that I need different setups for the different programs 
  21.          that I run.
  22.  
  23.          For example, while running BOBsBBS I want an 
  24.          AUTOEXEC.BAT file with the BULLET! command in it to start
  25.          the board in case of power failure. I also want all 
  26.          memory resident software removed from the system. BUT, I 
  27.          use Desqview while working with my terminal program.
  28.  
  29.          After several years of use, I found that I had several 
  30.          AUTOEXEC.BAT and CONFIG.SYS files and still other batch 
  31.          files to copy them back and forth. Although these files 
  32.          are relatively small (less than 1,000 bytes each), they 
  33.          occupy a full disk sector (2,048) on my system. Eight
  34.          or nine of these files can occupy quite a bit of room.
  35.  
  36.          So I wrote CONFIG.EXE. It's really a simple program. It 
  37.          will write copies of any files you want, and run DOS 
  38.          commands to setup your system the way you want it for a 
  39.          specific application. It then performs a warmboot.
  40.  
  41. FILES:   CONFIG.EXE The actual config program. Place it somewhere 
  42.                     in your PATH.
  43.          CONFIG.DAT The data file that drives CONFIG. It must 
  44.                     reside somewhere on the DOS path. This file 
  45.                     is a text file that contains command that 
  46.                     drive CONFIG. It can be edited with any text 
  47.                     editor that does not place special formatting 
  48.                     characters into the file.
  49.          CONFIG.DOC This documentation.
  50.          EDITOR.CMD Reference to full-screen editor commands
  51.          WHATS.NEW  New features of the current release.
  52.  
  53. RUNNING CONFIG.EXE
  54.  
  55. CONFIG.EXE can be started in one of several ways. If you type
  56. "CONFIG" at the prompt, the program will give you a summary of
  57. options. The following are the ways that the program can be
  58. started ("C>" represents the DOS prompt and should not be typed
  59. in the command. <Enter> is the enter key.)
  60.  
  61. C> CONFIG<Enter>
  62.  
  63.    Listing of command line options.
  64.  
  65. C> CONFIG {system}
  66.  
  67.    Run config and load the files represented by {system}.
  68.  
  69. C> CONFIG /e
  70.  
  71.    Edit or create the CONFIG.DAT file using CONFIG's full-screen
  72.    editor.
  73.  
  74. C> CONFIG /l
  75.  
  76.    Have config produce a list of systems in CONFIG.DAT. You can
  77.    then select the one that you want. It's handy if your memory
  78.    is failing like mine.
  79.  
  80. C> CONFIG {system} /e
  81.  
  82.    Edit the CONFIG.DAT file then load {system}. Handy if you have
  83.    to make a change then want to run the system.
  84.  
  85. C> CONFIG /e /l
  86.  
  87.    Edit the CONFIG.DAT file then list the systems and optionally
  88.    select one to be executed.
  89.  
  90. THE CONFIG.DAT FILE
  91.  
  92. This is a DOS text file which can be created using CONFIG's
  93. full-screen editor or any editor which does not introduce special
  94. formatting characters into the file. If you plan to use CONFIG's
  95. full-screen editor, this file can not be more that 64,000 bytes
  96. in size.
  97.  
  98. CONFIG.DAT can be placed anywhere along your DOS PATH. I suggest
  99. that you place it in the root directory.
  100.  
  101. FULL-SCREEN EDITOR
  102.  
  103. This is really a pretty nifty editor. It can handle a CONFIG.DAT
  104. file that's less that 64,000 bytes in size. The commands are
  105. contained in the separate file EDITOR.CMD. If you're familiar
  106. with Wordstar, Sidekick or the Turbo editors, these commands
  107. should be pretty familiar to you.
  108.  
  109. CONSIDERATIONS
  110.  
  111. In testing this program, I've found the following:
  112.  
  113. o If you use a program such as DPATH30.ARC to allow your programs
  114. to find files along the DOS PATH, you may confuse the full-screen
  115. editor if you don't edit CONFIG.DAT from the sub-directory where
  116. it's located. The other commands do not seem to have this
  117. problem. (It has to do with the way that the editor loads files.)
  118.  
  119. COMANDS
  120.  
  121. The following is summary of CONFIG commands. All  commands must
  122. start in column 1 (see the example CONFIG.DAT file.)
  123.  
  124. <SYSTEM_NAME>
  125.  
  126.          This must be the first line in the system entry. It can
  127.          be followed by a description of the system.
  128.  
  129.          When you enter the system name when CONFIG is evoked, it
  130.          looks for that tag within the angle brackets ("<>"). For 
  131.          example the command line "CONFIG clear" would search for 
  132.          the tag "<CLEAR>" and execute everything until it found 
  133.          an "<END>" tag.
  134.  
  135.          Please note: system names can NOT have and spaces or 
  136.          commas in them and they must be in CAPITAL LETTERS.
  137.  
  138. <END>    This tag ends the configuration for the system. For a 
  139.          given setup, CONFIG will execute everything from the 
  140.          <SYSTEM> tag and the <END> tag. NOTE: <END> must also be
  141.          in CAPITAL LETTERS.
  142.  
  143. /WRITE {filename}
  144.  
  145.          Write lines to the indicated file. A full pathname can 
  146.          be used. CONFIG will open the file for writing. All 
  147.          previous contents will be lost. Only one file can be 
  148.          open at a time. Another /WRITE or /APPEND command or 
  149.          <END> tag will close the previous file.
  150.  
  151.          CONFIG will write everything that it can't identify as a
  152.          command to this file.
  153.  
  154. /APPEND {filename}
  155.  
  156.          Same as the /WRITE command except that the information 
  157.          is appended to any existing information in the file. Any 
  158.          previously opened file will be closed.
  159.  
  160. !{options};{DOS command}
  161.  
  162.          A command line starting with an "!" will cause CONFIG to 
  163.          call another copy of COMMAND.COM and execute the command 
  164.          line following the semi-colon (";"), if any.
  165.  
  166.          The only option currently is "P" which causes CONFIG to 
  167.          pause after the command execution. If you have no 
  168.          options, start the command immediately after the 
  169.          exclamation mark ("!{command}").
  170.  
  171. /NOBOOT
  172.  
  173.          Supresses the execution of the warmboot when CONFIG is 
  174.          finished.
  175.  
  176. /BOOT?
  177.          Prompts the user whether to reboot or not. The default
  178.          it to reboot the system. To NOT reboot the system enter
  179.          'N' (upper or lower case).
  180.  
  181. /PAUSE,{seconds}
  182.  
  183.          Pause for the number of seconds indicated. This command
  184.          is useful if you are using a disk cache and your system
  185.          must have some time to complete writing the files to the
  186.          hard disk before the system reboot.
  187.  
  188. /COLD
  189.  
  190.          Instructs CONFIG to perform a cold boot rather than the
  191.          default warm boot.
  192.  
  193.  
  194. A sample CONFIG.DAT file:
  195.  
  196. --------- Top of file -------------
  197. <CLEAR>                                     This is the tag.
  198. /COLD                                       Perform a COLD boot
  199. /WRITE C:\AUTOEXEC.BAT                      Open the AUTOEXEC.BAT 
  200.                                             file for writing.
  201. path c:\bin;c:\frmwork;c:\msword;c:\
  202. chad
  203. dpath30
  204. prompt $p$g
  205. mode bw80
  206. 1dirplus
  207. /WRITE C:\CONFIG.SYS                        All lines prior to 
  208.                                             this /WRITE command 
  209.                                             are written to the 
  210.                                             AUTOEXEC.BAT file. 
  211.                                             Open the CONFIG.SYS 
  212.                                             file and close the 
  213.                                             AUTOEXEC.BAT file.
  214. DEVICE=\BIN\ANSI.SYS
  215. FILES=20
  216. BUFFERS=20
  217. /BOOT?                                      Prompts the user to
  218.                                             reboot system.
  219. <END> CLEAR                                 This marks the end of 
  220.                                             the CLEAR system.
  221. <DV>                                        This is the start of 
  222.                                             a new system setup.
  223. /WRITE C:\AUTOEXEC.BAT
  224. path c:\bin;c:\frmwork;c:\msword;c:\
  225. set CBSIZE=10240
  226. chad
  227. dpath30
  228. prompt [DV ] $p$g
  229. c:
  230. cd \dv
  231. break off
  232. dv
  233. cd \
  234. /WRITE C:\CONFIG.SYS
  235. DEVICE=\BIN\ANSI.SYS
  236. FILES=20
  237. BUFFERS=20
  238. /NOBOOT                                     Don't boot the system 
  239.                                             upon exit from 
  240. .                                            CONFIG>
  241. <END> DV
  242. <FW>
  243. /WRITE C:\AUTOEXEC.BAT
  244. path c:\bin;c:\frmwork;c:\msword;c:\
  245. chad
  246. mode bw80
  247. cd \frmwork
  248. fw l.fw2/x/t
  249. CONFIG CLEAR
  250. /WRITE C:\CONFIG.SYS
  251. DEVICE=\BIN\ANSI.SYS
  252. FILES=20
  253. BUFFERS=20
  254. /PAUSE,3                         Pauses 3 seconds before
  255.                                  rebooting system.
  256. <END> FW
  257. * END OF FILE CONFIG.DAT
  258.  
  259. ---------- End of File ----------------
  260.  
  261. I really don't like the stuff that follows, but I have to do it 
  262. just because there are a few twits out there who make it 
  263. necessary.
  264.  
  265. OK, it's about time to cover my . . . .
  266.  
  267. You got this program for free, right? (If anyone did charge you 
  268. for it, look below and the notify me!) You can use it for 
  269. whatever you see fit. Of course, I can't be responsible for any 
  270. damages you cause by using the program.
  271.  
  272. Since I don't know what you're going to use CONFIG for, I can 
  273. make no warrantees that it's good for anything! (I've tested it 
  274. on my Kaypro 286i and Toshiba T3100, but I can't even be certain 
  275. that it will work on your system even if you have the same 
  276. computer!)
  277.  
  278.  
  279. And now for the other legal stuff . . .
  280.  
  281. I (Bob Breedlove) retain all rights to this program. By giving it 
  282. away free, I am NOT releasing any rights to the program, its 
  283. concepts, etc. If you use or distribute the program, you are 
  284. agreeing to the following:
  285.  
  286. You can give the program away to whoever you want, but you can't
  287. charge them any money for it. You also can't charge a fee for 
  288. diskettes or other media that you use to distribute the software. 
  289. (If you're a BBS and you charge for access, then that's OK. But, 
  290. it's the only exception.)
  291.  
  292. You also can't distribute it with other software for 
  293. profit or free-of-charge. If you do choose to distribute it, 
  294. keep the original archive file together just as it is. You can't 
  295. include the archive file in other software packages, collections, 
  296. etc. without my express written permission (see the address 
  297. above).
  298.  
  299. If you're a user's group and you want to include the archive in 
  300. your member library, that 's OK, but, again, you can't charge to
  301. distribute it! 
  302.  
  303. If you're one of those companies that charge people for diskettes 
  304. to distribute for other people's software -- FORGET IT! -- unless 
  305. of course, you want to send me 80% of what you charge!
  306.  
  307. If you are an end-user and you find CONFIG.EXE in a collecton of 
  308. software that you have been charged for, CALL THE COMPANY AND 
  309. DEMAND YOUR MONEY BACK!!!!
  310.  
  311.